IOCTL_DISK_ARE_VOLUMES_READY 제어 코드

지정된 디스크의 모든 볼륨이 사용할 준비가 될 때까지 기다립니다.

이 작업을 수행하려면 다음 매개 변수를 사용하여 DeviceIoControl 함수를 호출합니다.

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device 
                 IOCTL_DISK_ARE_VOLUMES_READY,   // dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer 
                 (DWORD)        0,               // nInBufferSize 
                 (LPVOID)       NULL,            // lpOutBuffer 
                 (DWORD)        0,               // nOutBufferSize
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

매개 변수

hDevice

디스크에 대한 핸들입니다.

디바이스 핸들을 검색하려면 CreateFile 함수를 호출합니다.

dwIoControlCode

작업에 대한 컨트롤 코드입니다.

이 작업에 는 IOCTL_DISK_ARE_VOLUMES_READY 사용합니다.

lpInBuffer

이 작업에는 사용되지 않습니다. NULL로 설정합니다.

nInBufferSize

입력 버퍼의 크기(바이트)입니다. 0으로 설정합니다.

lpOutBuffer

이 작업에는 사용되지 않습니다. NULL로 설정합니다.

nOutBufferSize

이 작업에는 사용되지 않습니다. 0으로 설정합니다.

lpBytesReturned

이 작업에는 사용되지 않습니다. NULL로 설정합니다.

lpOverlapped

OVERLAPPED 구조체에 대한 포인터입니다.

FILE_FLAG_OVERLAPPED 지정하지 않고 hDevice를 연 경우 lpOverlapped는 무시됩니다.

FILE_FLAG_OVERLAPPED 플래그를 사용하여 hDevice를 연 경우 작업이 겹치는(비동기) 작업으로 수행됩니다. 이 경우 lpOverlapped 는 이벤트 개체에 대한 핸들이 포함된 유효한 OVERLAPPED 구조를 가리킵니다. 그렇지 않으면 예기치 않은 방법으로 함수가 실패합니다.

겹치는 작업의 경우 DeviceIoControl 이 즉시 반환되고 작업이 완료되면 이벤트 개체에 신호가 전송됩니다. 그렇지 않으면 작업이 완료되거나 오류가 발생할 때까지 함수가 반환되지 않습니다.

반환 값

디스크의 모든 볼륨을 사용할 준비가 되었음을 나타내는 작업이 성공적으로 완료되면 DeviceIoControl 은 0이 아닌 값을 반환합니다.

작업이 실패하거나 보류 중인 경우 DeviceIoControl 은 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2012 [데스크톱 앱만 해당]
헤더
Ntdddisk.h

추가 정보

DeviceIoControl

디스크 관리 제어 코드